Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Finder Dialog Box Messages

GXHandleAlertStatus

The Finder or QuickDraw GX may send the GXHandleAlertStatus message. You need to override the GXHandleAlertStatus message if you want to display status or error dialog boxes that are more complex than those supported by the standard status handling. Your override of the GXHandleAlertStatus message must match the following formal declaration:

OSErr MyHandleAlertStatus (gxStatusRecord *statRecPtr);

statRecPtr

A pointer to the status structure.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The Finder sends the GXHandleAlertStatus message when it receives the status from a background printing process and wishes to alert the user. QuickDraw GX sends the GXHandleAlertStatus message when a printer driver calls the GXAlertTheUser function with a status structure containing a status type of gxUserAttention.

The default implementation of this message expects that the caller wants to display a printing alert box and performs the actions necessary to do so.

You need to override this message if you want to display status dialog boxes or printing alert boxes that are more complex than are supported by this standard status handling. If you want to override this message, you first check the statusOwner field of the status structure to make sure that this message is intended for you. If it is intended for you,
you are free to manage the dialog box yourself.

SPECIAL CONSIDERATIONS

You never send the GXHandleAlertStatus message yourself.

If you handle the status, perform a total override of the GXHandleAlertStatus message. Otherwise, forward the message so that another message handler can process it.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The GXAlertTheUser function is described on page 5-18 in the chapter "Printing Functions for Message Overrides" in this book.

The status structure is described on page 4-39.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help